<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!-- Copyright 1997 The Open Group, All Rights Reserved -->
<title>uuto</title>
</head><body bgcolor=white>
<center>
<font size=2>
The Single UNIX &reg; Specification, Version 2<br>
Copyright &copy; 1997 The Open Group

</font></center><hr size=2 noshade>
<h4><a name = "tag_001_014_2752">&nbsp;</a>NAME</h4><blockquote>
uuto - send public system-to-system file copies (<b><a href="intro.html#tag_001_003_003">LEGACY</a></b>)
</blockquote><h4><a name = "tag_001_014_2753">&nbsp;</a>SYNOPSIS</h4><blockquote>
<pre><code>

uuto <b>[</b>-mp<b>]</b><i> source-file</i>...<i> destination</i>
</code>
</pre>
</blockquote><h4><a name = "tag_001_014_2754">&nbsp;</a>DESCRIPTION</h4><blockquote>
The
<i>uuto</i>
utility
sends
<i>source-files</i>
to
<i>destination</i>.
The
<i>uuto</i>
utility
uses the
<i><a href="uucp.html">uucp</a></i>
facility to send files,
while it allows the local system to control the file access.
A
<i>source-file</i>
name is a pathname on the user's machine.
<p>
The files (or subtrees if directories are specified) are sent to
a public directory (called
<i>"PUBDIR"</i>;
the actual location of
<i>PUBDIR</i>
is implementation-dependent)
on
<i>system</i>.
Specifically, the files are sent to the directory:
<pre>
<code>
<i>PUBDIR</i>/receive/<i>user</i>/<i>fsystem</i>
</code>
</pre>
<p>
where
<i>user</i>
is the recipient, and
<i>fsystem</i>
is the sending system.
<p>
The recipient is notified by
mail of the arrival of files.
<p>
Typical implementations of this utility require a communications
line configured to use the <b>XBD</b> specification, <a href="../xbd/termios.html"><b>General Terminal Interface</b>&nbsp;</a> ,
but other communications means may be used.
On systems where there are no available communications means
(either temporarily or permanently), this
utility will write an error message describing the problem
and exit with a non-zero exit status.
<p>
The
<i>uuto</i>
utility cannot guarantee support for all character encodings
in all circumstances.
For example,
transmission data may be restricted to 7-bits by the underlying
network, 8-bit data and filenames need not be portable to
non-internationalised systems, and so on.
Under these circumstances, it is recommended that only
characters defined in the
ISO/IEC&nbsp;646:1991 standard International Reference Version
(equivalent to ASCII) 7-bit range of
characters be used and that only characters defined in the Portable
Filename Character Set be used for naming files.
</blockquote><h4><a name = "tag_001_014_2755">&nbsp;</a>OPTIONS</h4><blockquote>
The
<i>uuto</i>
utility supports the <b>XBD</b> specification, <a href="../xbd/utilconv.html#usg"><b>Utility Syntax Guidelines</b>&nbsp;</a> .
The following options are supported:
<p>
<dl compact>

<dt><b>-m</b>
<dd>Send mail to the sender when the copy is complete.

<dt><b>-p</b>
<dd>Copy the source file into the spool directory before transmission.

</dl>
</blockquote><h4><a name = "tag_001_014_2756">&nbsp;</a>OPERANDS</h4><blockquote>
The following operands are supported:
<dl compact>

<dt><i>destination</i><dd>
A string of the form:
<pre>
<code>
<i>system-name</i>!<i>user</i>
</code>
</pre>

where
<i>system-name</i>
is taken from a list of system names that
<i><a href="uucp.html">uucp</a></i>
knows about; see
<i><a href="uuname.html">uuname</a></i>.
The argument
<i>user</i>
is the login name of someone on the specified system.
The destination
<i>system-name</i>
can also be a list of names such as:
<pre>
<code>
<i>system-name</i>!<i>system-name</i>!<i>...</i>!<i>system-name</i>!<i>user
</i></code>
</pre>

in which case, an attempt is made to send the file via the specified route
to the destination.
Care should be taken to ensure that intermediate nodes in the
route are willing to forward information.

<dt><i>source-file</i><dd>
A pathname of a file on the local system to be copied to
<i>destination</i>.

</dl>
</blockquote><h4><a name = "tag_001_014_2757">&nbsp;</a>STDIN</h4><blockquote>
Not used.
</blockquote><h4><a name = "tag_001_014_2758">&nbsp;</a>INPUT FILES</h4><blockquote>
The files to be copied are regular files.
<br>
</blockquote><h4><a name = "tag_001_014_2759">&nbsp;</a>ENVIRONMENT VARIABLES</h4><blockquote>
The following environment variables affect the execution of
<i>uuto</i>:
<dl compact>

<dt><i>LANG</i><dd>Provide a default value for the internationalisation variables
that are unset or null.
If
<i>LANG</i>
is unset or null, the corresponding value from the
implementation-dependent default locale will be used.
If any of the internationalisation variables contains an invalid setting, the
utility will behave as if none of the variables had been defined.

<dt><i>LC_ALL</i><dd>
If set to a non-empty string value,
override the values of all the other internationalisation variables.

<dt><i>LC_CTYPE</i><dd>
Determine the
locale for the interpretation of sequences of bytes of text data as
characters (for example, single- as opposed to multi-byte characters
in arguments and input files).

<dt><i>LC_MESSAGES</i><dd>
Determine the locale that should be used to affect
the format and contents of diagnostic
messages written to standard error,
and informative messages written to standard output.

<dt><i>NLSPATH</i><dd>
Determine the location of message catalogues
for the processing of
<i>LC_MESSAGES .
</i>
</dl>
</blockquote><h4><a name = "tag_001_014_2760">&nbsp;</a>ASYNCHRONOUS EVENTS</h4><blockquote>
Default.
</blockquote><h4><a name = "tag_001_014_2761">&nbsp;</a>STDOUT</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2762">&nbsp;</a>STDERR</h4><blockquote>
Used only for diagnostic messages.
</blockquote><h4><a name = "tag_001_014_2763">&nbsp;</a>OUTPUT FILES</h4><blockquote>
The output files (which may be on other systems)
are copies of the input files.
</blockquote><h4><a name = "tag_001_014_2764">&nbsp;</a>EXTENDED DESCRIPTION</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2765">&nbsp;</a>EXIT STATUS</h4><blockquote>
The following exit values are returned:
<dl compact>

<dt>0<dd>Successful completion.

<dt>&gt;0<dd>An error occurred.

</dl>
</blockquote><h4><a name = "tag_001_014_2766">&nbsp;</a>CONSEQUENCES OF ERRORS</h4><blockquote>
Default.
</blockquote><h4><a name = "tag_001_014_2767">&nbsp;</a>APPLICATION USAGE</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2768">&nbsp;</a>EXAMPLES</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2769">&nbsp;</a>FUTURE DIRECTIONS</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2770">&nbsp;</a>SEE ALSO</h4><blockquote>
<i><a href="mailx.html">mailx</a></i>,
<i><a href="uucp.html">uucp</a></i>,
<i><a href="uuencode.html">uuencode</a></i>,
<i><a href="uupick.html">uupick</a></i>,
<i><a href="uustat.html">uustat</a></i>,
<i><a href="uux.html">uux</a></i>.
</blockquote><hr size=2 noshade>
<center><font size=2>
UNIX &reg; is a registered Trademark of The Open Group.<br>
Copyright &copy; 1997 The Open Group
<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]

</font></center><hr size=2 noshade>
</body></html>
